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1 Signal Types 



TiA defines the following signals types. 



Identifier (string) 


Value (hex) 


Value (dec) 


Description 


eeg 


0x00000001 


1 


Electroencephalogram 


emg 


0x00000002 


2 


Electromyogram 


eog 


0x00000004 


4 


Electrooculogram 


ecg 


0x00000008 


8 


Electrocardiogram 


hr 


0x00000010 


16 


Heart rate 


bp 


0x00000020 


32 


Blood pressure 


button 


0x00000040 


64 


Buttons (aperiodic) 


joystick 


0x00000080 


128 


Joystick axis (aperiodic) 


sensors 


0x00000100 


256 


Sensor 


nirs 


0x00000200 


512 


NIRS 


fmri 


0x00000400 


1,024 


FMRI 


mouse 


0x00000800 


2,048 


Mouse axis (aperiodic) 


mouse-button 


0x00001000 


4,096 


Mouse buttons (aperiodic) 


not used yet 








user_l 


0x00010000 


65,536 


User I 


user_2 


0x00020000 


131,072 


User 2 


use r_3 


0x00040000 


262,144 


User 3 


user_4 


0x00080000 


524,288 


User 4 


undefined 


0x00100000 


1,048,576 


undefined signal type 


event 


0x00200000 


2,097,152 


event 



1.1 Aperiodic Signals 

Aperiodic signals are signals which are not transmitted at constant time rates. For example the state of joystick 
axis. 

Therefore values of the current state of these signals have be transmitted only if they have changed. 

2 Control Connection 

A TiA server has to provide a TCP port on which clients can create a control connection. Each client gets its own 
control connection to the server 

The control connection can be used by the clients to send requests to the server such as "start/stop data transmis- 
sion". 

Some important remarks: 

1. The protocol is in the style of HTTP (line structured text messages) 

2. The messages are encoded in UTF-8 

3. The message is split into lines which are terminated by the OxOA character (also known as \n, "line feed" 
or <LF>) 

4. Some messages contain additional XML-structured content which is UTF-8 encoded 

5. All characters are case sensitive! 

2.1 Control Message Structure 

Each message which is send from the client to the server or vice versa is structured as followed: 
1 . Version line 



2. Command line 

3. Optional content description line 

4. An empty line 

5. Optional xml-stmctured content 
Example: 

TiA 1.0\n 

CheckProtocolVersion\n 
\n 

Example with additional xml-structured content 

TiA 1.0\n 
Metainf o\n 

Content-Length: 79\n 
\n 

<?xml version="l . 0" encoding="UTF-8 " ?><tiaMetaInf o version="l . 0"></tiaMetaInf o> 



2.2 Reply Messages 

Each command message is answered with an reply message which contains either an OK or an Error. Error 
messages optionally contain an error description. 

OK message: 

TiA 1.0\n 

OK\n 
\n 

Error message without an error description: 

TiA 1.0\n 
Error \n 
\n 

Error message including an error description: 

TiA 1.0\n 
Error \n 

Content-Length: 73\n 
\n 

<tiaError version=" 1 . " description="Human readable error description ." /> 



2.3 Server Commands 

A TiA 1.0 server implementation has to support the following commands: 

• Check protocol version 

• Get metainfo 

• Get data connection 

• Start data transmission 

• Stop data transmission 

• Get server state connection 



Check Protocol Version 

This command may be used by the cUent to check if the server understands the commands the client wants to send. 
The server has to respond with an OK message if it understands commands of the given protocol version. 

Representation: 

TiA 1.0\n 

CheckProtocolVersion\n 
\n 

Server responses either with an OK or an error message. 
Get Metalnfo 

This command is used to get the informations about the signals from the server. 
Representation: 

TiA 1.0\n 

GetMetalnfoXn 

\n 

Server response: 

TiA 1.0\n 
Metainf o\n 

Content-Length: [Length of XML Content in Bytes] \n 
\n 

<?xml version="l . 0" encoding="UTF-8 " ?><tiaMetaInf o version=" 1 . ">.... </tiaMetaInfo> 
or an error message. 

Get Data Transmission 

Two types of data transmissions exist: "TCP" and "UDP". 
Representation: 

TiA 1.0 \n 

GetDataConnection : TCP \n 
\n 

or 

TiA 1.0 \n 

GetDataConnection: UDP \n 
\n 

Server Response: 

TiA 1.0 \n 

DataConnectionPort : [ Port -Number ] \n 
\n 

or an error message. 
Start Data Transmission 



Representation: 



TiA 1.0 \n 

StartDataTransmission \n 
\n 

Server responses either with an OK or an error message. 

Stop Data Transmission 

Representation: 

TiA 1.0 \n 

StopDataTransmission \n 
\n 

Server responses either with an OK or an error message. 

Get Server State Connection 

Representation: 

TiA 1.0\n 

GetServerStateConnection\n 
\n 

Server Response: 

TiA 1.0\n 

ServerStateConnectionPort : [Port-Number] \n 
\n 

or an error message. 

2.4 TiA Meta Info 

The TiA meta info is structured in XML and contains information about the signals and the subject. 

2.5 TiA Error Description 

An error message in TiA version 1.0 optionally supports an error description in a human readable format. No error 
codes with special meaning are supported in this version. 

3 Server State Connection 

Additionally to the control- and data-connection a client may request a so called "server state connection". 
This connection is used by the server to transmit messages about its state to the clients. 

3.1 State Messages 



• Server running 

• Server shut down 



Server Running 



Just to indicate that the server is running. 

TiA 1.0\n 

Server St at eRunning\n 
\n 

Clients must no reply to this message. 
Server Shut Down 

Indicates that the server will shut down soon. Therefore the control and the data connection will be closed by the 
server soon. 

TiA 1.0\n 

Server St ate Shut down \n 
\n 



Clients must not reply to this message. 



4 Data Packet 



TiA RAW Data Packet Structure: 

(with exemplary content) 



IP Header 


UDP or TCP Header 


TiA Data packet header 


EEG ch 1 (s 1) 


EEG ch 2 (s 1) 


EEG ch 3 (si) 


EEG ch4 (s 1) 


EEG ch5 (si) 


• • • 


EMG ch 1 (s 1) 


EMG ch 1 (s 2) 


EMG chl (s3) 


EMG ch 1 (s 4) 


EMG ch2 (si) 


EMGch2(s2) 


EMG ch2 (s3) 


EMG ch2 (s4) 




• • • 



.EEG 

(blocksize — 1, 
several channels) 

,EMG 

(blocksize = 4, 
2 channels) 



-EOG, EGG, 



TiA Data packet header: 

uintS Version 



uint64 ConncctionPacketNr 





uint32 Size 


uint32 Flags 


uint64 PacketNr 




\ 


uint64 Timestamp 


\ i / 


\ i / r 



a 



data 



data 



uintl6[] NrCliannels uintl6[] SamplesPerChannel 



4.1 Fixed Header 



Position (Byte) 


Lengtli (Byte) 


Type 


Content 





1 


unsigned integer 


Datapacket Version has to be 3 


1 


4 


unsigned integer 


Packet size (in bytes), little endian 


5 


4 


unsigned integer 


Signal type flags 


9 


8 


unsigned integer 


Packet id 


17 


8 


unsigned integer 


Connection packet number 


25 


8 


unsigned integer 


Time stamp 



Byte Order 

All data and fields are transmitted in little endian. 



Packet Size 

The packet size is the total number of bytes (octets) of a datapacket including the fixed header, the variable header 
and the data. 

The packet size of an empty datapacket is 33. 



Time Stamp 



microseconds since server start 



4.2 Variable Header 



Remarks: 



• NoS is the number of signals. This number can be determined by counting the flags which are set in the 
"signal type flags" field of the fixed header. 



Position 
(Byte) 


Length 
(Byte) 


Type 


Content 


33 

33 + (2 * 
NoS) 


2* NoS 
2* NoS 


Array of 16bit unsigned 
integer 

Array of 16bit unsigned 
integer 


Number of channels 

Block size of signal (number of samples per 
channel) 



4.3 Data 

Data starts at the position 33 + (4 * NoS). Sample values are transmitted as a sequence of 32bit floats (IEEE 754). 
Samples are firstly ordered by their signal type number {Singed Types). 



5 Outlook 

Future versions of TiA should guarantee downward compatibility. That means all TiA 1.0 commands should be 
supported by at least all 1.x versions. 

5.1 Error Messages 

Error messages may contain error codes to automatically interpret the meaning of an error. 

5.2 Datapackets 

Important remark: Due to downward compatibility no datapacket can become version 10! (as the first byte in 
datapacket version 2 is "10"). 

6 Appendix 

6.1 TiA Metalnfo XML Schema 

<?xml version="l . 0" encoding="UTF-8 " ?> 
<! — 

This is the XML Schema for the meta info XML representation version 1.0 
of TOBI Interface A (TiA) 

Version 1 . 

author: Christoph Eibel 

— > 

<xsd: schema xmlns : xsd="http : / /www .w3.org/200 1 /XML Schema "> 
<xsd: element name="t iaMetaInf o "> 
<xscl: complexType> 
<xsd : sequence> 

<.'-- subject info — > 

<xsd : element name="subject" minOccurs=" " maxOccur s=" 1 "> 



17 <xsd : complexType> 

18 <xsd: attribute name="id" type="xsd: string" use="optional " /> 

19 <xsd: attribute name="f irstName" type="xsd: string" use="optional"/> 

20 <xsd: attribute name=" surname" type="xsd : string" use="optional"/> 

21 <xsd: attribute name="sex" use="optional"> 

22 <xsd: simpleType> 

23 <xsd: restriction base="xsd: string"> 

24 <xsd : enumeration value="m" /> 

25 <xsd : enumeration value = "f" /> 

26 </xsd: restriction> 

27 </xsd: simpleType> 

28 </xsd: attribute> 

29 <xsd: attribute name="birthday " type="xsd: date" use="optional"/> 

30 <xsd: attribute name="handedness" use="optional "> 

31 <xsd: simpleType> 

32 <xsd: restriction base="xsd: string"> 

33 <xsd: enumeration value="l" /> 

34 <xsd: enumeration value = "r" /> 

35 </xsd: restriction> 

36 </xsd: simpleType> 

37 </xsd:attribute> 

38 <xsd: attribute name="medication" tYpe="xsd : boolean" use="optional " /> 

39 <xsd: attribute name="glasses " type="xsd : boolean" use="optional" /> 

40 <xsd: attribute name="smoker" type="xsd:boolean" use="optional" /> 

41 </xsd: complexType> 

42 </xsd: element> 

43 

44 </-- master signal info — > 

45 <xsd:element name="masterSignal" minOccurs=" " maxOccurs=" 1 "> 

46 <xsd : complexType> 

47 <xsd: attribute name="samplingRate" type="xsd : float " use="required"/> 

48 <xsd: attribute name="blockSize" type="xsd : integer " use="required"/> 

49 </xsd: complexType> 

50 </xsd: element> 

51 
52 

53 </-- signal info — > 

54 <xsd:element name="signal" minOccur s=" " maxOccurs="unbounded"> 

55 <xsd : complexType> 

56 

57 </-- channels — > 

58 <xsd: sequence> 

59 <xsd:element name="channel" rainOccurs=" " maxOccurs="unbounded"> 

60 <xsd : complexType> 

61 <xsd : attribute name="nr" tYpe="xsd: nonNegativelnteger" use="required"/> 

62 <xsd : attribute name="label" type="xsd: string" use="required"/> 

63 </xsd: complexType> 

64 </xsd:element> 

65 </xsd: sequenc> 

66 

67 <! — signal type: as defined in TiA 1.0 — > 

68 <xsd: attribute name="type" use="required"> 

69 <xsd: simpleType> 

70 <xsd: restriction base="xsd: string"> 

71 <xsd: enumeration value="eeg" /> 

72 <xsd : enumeration value="emg" /> 

73 <xsd : enumeration value="eog" /> 

74 <xsd : enumeration value="ecg" /> 

75 <xsd: enumeration value="hr" /> 

76 <xsd: enumeration value = "bp" /> 

77 <xsd: enumeration value="buttons " /> 

78 <xsd : enumeration value=" joystick" /> 

79 <xsd: enumeration value=" sensor s " /> 



80 <xsd: enumeration value="nirs" /> 

81 <xsd : enumeration value="fmri" /> 

82 <xsd: enumeration value="undef ined" /> 

83 </xsd: restriction> 

84 </xsd: simpleType> 

85 </xsd : attribute> 

86 

87 <xsd: attribute name="samplingRate" type="xsd : float " use="required"/> 

88 <xsd: attribute name="blockSize" type="xsd: integer" use="required"/> 

89 <xsd: attribute name="numChannels " type="xsd : nonNegat ivelnteger " use="required"/> 

90 </xsd: complexType> 

91 </xsd: element> 

92 

93 </xsd: sequence> 

94 

95 </-- version attribute — > 

96 <xsd : attribute name="version" type="xsd : string" fixed="1.0" use=" required" /> 

97 

98 </xsd: complexType> 

99 </xsd:element> 

100 

101 </xsd : schema> 



6.2 TiA Metalnfo XML Example 

1 <?xml version="l . 0" encoding="UTF~8 " ?> 

2 <tiaMetaInfo version=" 1 . "> 



3 

4 <subject id="WE2" f irstNaine="Max" lastName="Mustermann" 

5 handedness="r" /> 

6 

7 <masterSignal sampleRate="100" blockSize=" 1 " /> 

8 

9 <signal type="eeg" blockSize=" 10 " sampleRate=" 100 " numChannels="3"> 

10 <channel nr="l" label="Cz"/> 

11 <channel nr="2" label="Cl"/> 

12 <channel nr="3" label="C2"/> 

13 </signal> 

14 

15 <signal type="bp" blockSize=" 5 " sampleRate=" 50 " numChannels="5"> 

16 <channel nr="3" label="Channel 3 with Label"/> 

17 <channel nr="2" label="Channel 2 with Label"/> 

18 < ! — 

19 Channel 1, 4 and 5 have no labels 

20 — > 

21 </signal> 

22 



23 </tiaMetaInfo> 



6.3 TiA Error Message XML Schema 



